home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-19 / gpt32src.zip / README.INS < prev    next >
Text File  |  1992-05-16  |  8KB  |  206 lines
  1. The GNUPLOT source code and executables may be copied and/or modified
  2. freely as long as the copyright messages are left intact.
  3.  
  4. See the History file for changes to GNUPLOT.
  5.  
  6. Compilation instructions are near the end of this file.
  7.  
  8. GNUPLOT has been tested on Sun3's and Sun4's (SunOS 4.0.3 and 4.1.1),
  9. a VAX 6410 (VMS 5.2), Commodore Amiga's (KS/WB 1.3 and 2.0, Lattice C
  10. and Aztec C beta 5.2a), IBM PC XT's and AT's (MS-DOS 3.3/5.0 BC++ 2.0/TC++
  11. 1.0), IRIS 4D/70G and 4D/25G with MIPS C, NeXT with gnu C 1.34,
  12. DECStation 5000/200PXG (ULTRIX V4.1),
  13. AT&T 3B1 (version 3.51m with cc and gcc 1.39),
  14. and Apollo's (DomainOS SR10.3 BSD4.3 with C compiler 68K Rev 6.7(316)).
  15. The code is written with portability in mind.
  16. GNUPLOT has not been tested on Pyramid 90x and IBM PC Microsoft C.
  17.  
  18. Send your comments, suggestions, or modifications to 
  19.   info-gnuplot@ames.arc.nasa.gov
  20. This is a mailing list; to join it send a note to 
  21.   info-gnuplot-request@ames.arc.nasa.gov
  22. Send bug reports to
  23.   bug-gnuplot@ames.arc.nasa.gov
  24.  
  25.                        PREPROCESSOR #DEFINES
  26.  
  27. These #defines should be checked before compilation (see the makefiles):
  28. define      file            note
  29. ------      ----            --------
  30. NOVFORK     Makefile        define if you don't have the vfork() system call
  31. GAMMA       Makefile        define if you've got gamma(3)
  32. MEMCPY      Makefile        define if your bcopy() is called memcpy()
  33. MEMSET      Makefile        define if you have memset() but not bzero()
  34. NOCOPY      Makefile        define if you've don't have a memcpy() by any name
  35. bcopy()     plot.h          define if you've got a memcpy() by some OTHER name
  36.                               (see example in plot.h)
  37. PC          Makefile        define if compiling on a PClone
  38. MSDOS       Makefile        define if compiling under MSDOS;
  39.                               automatically defined by Microsoft C 5.10
  40. HELPFILE    Makefile        name including path of gnuplot.gih file.
  41. VERYLARGE   plot.h          define to be largest coordinate number.
  42. SHELL       plot.h          default shell to spawn if SHELL environment
  43.                               variable not found at run-time
  44. NOCWDRC     Makefile        define to inhibit check of ./.gnuplot
  45. READLINE    Makefile        define if you want command-line editing
  46.  
  47. Valid TERMFLAGS defines.  These defines are used to include the
  48. various plotting terminals, printers, and protocols that a given version
  49. of gnuplot can access:
  50.  
  51. define         file            note
  52. ------      ----            --------
  53. TERMFLAGS   Makefile        the set of terminals you want, from below
  54.             or term.h
  55.  
  56.    AED         AED 512 and AED 767
  57.    AIFM        Adobe Illustrator Format
  58.    AMIGASCREEN Amiga custom screen
  59.    APOLLO      Apollo Graphics Primitive Resource (resizable window)
  60.    ATT6300     PC with AT&T 6300 graphics
  61.    BITGRAPH    BBN BitGraph
  62.    CGI         SCO CGI
  63.    CORONA      PC with Corona graphics 325
  64.    DXY800A     Roland DXY800A plotter
  65.    DUMB           Printer or glass dumb terminal
  66.    DXF           AutoCad (Release 10.x) dxf file format
  67.    EEPIC       EEPIC-extended LaTeX driver, for EEPIC users
  68.    EGALIB      PC with EGA/VGA graphics.
  69.    EMTEX       LATEX picture environment with emTeX specials
  70.    EPS60       Epson-style 60-dot per inch printers
  71.    EPSONP      Epson LX-800, Star NL-10, NX-1000 and lots of others
  72.    FIG         Fig graphics language (requires object.h from TransFig)
  73.    GPR         Apollo Graphics Primitive Resource (fixed-size window)
  74.    HERCULES    IBM PC/Clone with Hercules graphics board
  75.    HP2648      HP2648, HP2647
  76.    HP26        HP2623A and maybe others
  77.    HP75        HP7580, and probably other HPs
  78.    HPGL        HP7475 and (hopefully) lots of others
  79.    HPLJII      HP Laserjet II
  80.    HPLJIII     HP Laserjet III (HPGL/2)
  81.    IMAGEN      Imagen laser printers (300dpi) (requires -Iterm also)
  82.    IRIS4D      IRIS4D series computer
  83.    KERMIT      MS-Kermit Tektronix 4010 emulator
  84.    LATEX       LATEX picture environment
  85.    LN03P       DEC LN03P laser printer
  86.    NEC         NEC CP6 pinwriter printer
  87.    PBM         PBMPLUS pbm, pgm, ppm formats
  88.    POSTSCRIPT  Postscript
  89.    PRESCRIBE   Kyocera Laser printer
  90.    QMS         QMS/QUIC laserprinter (Talaris 1200 and others)
  91.    REGIS       ReGis graphics (vt125, vt220, vt240, Gigis...)
  92.    SELANAR     Selanar
  93.    STARC       Star Color Printer
  94.    SUN         Sun Microsystems Workstation
  95.    T410X       Tektronix 4106, 4107, 4109 and 420x terminals
  96.    TANDY60     Tandy DMP-130 series 60-dot per inch graphics
  97.    TEK         Tektronix 4010, and probably others
  98.    UNIXPC      unixpc (ATT 3b1 or ATT 7300)
  99.    UNIXPLOT    unixplot
  100.    V384        Vectrix 384 and tandy color printer
  101.    VTTEK       VT like Tektronix 4010 emulator
  102.    X11         X11R4 window system
  103.  
  104.  
  105. These #defines are defined automatically by various compilers, some
  106. gnuplot routines check these defines to implement features found in the
  107. various environments:
  108.  
  109. define           note
  110. ------        --------
  111. AMIGA_AC_5    defined for Manx Aztec C 5.2a on the Amiga
  112. AMIGA_LC_5_1  defined for Lattice C 5.01 on the Amiga
  113. apollo        defined by Apollo's C compilers.
  114. _CRAY         defined by CRAY's C compiler.
  115. __TURBOC__    defined automatically by Turbo C 2.0, C++ 1.0, Borland C++ 2.0
  116. unix          defined by most unix C compilers.  
  117. vms           (and VMS) defined by VAX-11 C under VMS.
  118. __ZTC__       Zortech C compiler under MSDOS.
  119.  
  120.  
  121.                              TO COMPILE
  122.  
  123. under UNIX:  
  124. To compile do:
  125.   Copy makefile.unx to Makefile
  126.       cp makefile.unx Makefile
  127.   Look through the Makefile to see if you need to make any changes.
  128.   See especially the HELPDEST and TERMFLAGS variables.  Edit if needed.
  129.   Alternatively, all these variables may be set as command line arguments to
  130.   'make'. For example:
  131.  
  132.     make <MACHINE> HELPDEST='/usr/um/misc/lib/gnuplot.gih' \
  133.         DEST='/usr/um/misc/bin' READLINE=
  134.  
  135.   Edit term.h, to include/exclude terminals
  136.   Type
  137.       make
  138.   For further instructions.
  139.   If that works, try
  140.       make install
  141.   For further instructions.
  142.  
  143. under VMS:  
  144.   To compile:
  145.      copy makefile.vms makefile.
  146.      make
  147.   Or if you don't have a suitable make:
  148.      @buildvms
  149.   To tell gnuplot where to find the help library:
  150.       $ define gnuplot$help disk:[directory]gnuplot.hlb
  151.   Alternatively (and preferably) put the help in the main system help library.
  152.  
  153. under AmigaDOS:
  154. Using Aztec C 5.2a
  155.       make -f makefile.ami
  156. Using Lattice C 5.1
  157.       lmk -f makefile.amg
  158.  
  159. under MSDOS:
  160. Using Microsoft C 5.10.
  161.       copy makefile.msc makefile
  162.       make makefile
  163.  
  164. Using Borland C++ 2.0, Turbo C++ 1.0
  165.       copy makefile.tc makefile
  166.   Edit makefile to change TC, BIN, BGI, BGIOBJ. You may also want to turn
  167.       on overlays (See manual for more on overlays).
  168.   Edit linkopt.tc (linkopt.tco if overlays on) to change location of
  169.       libraries.
  170.       make
  171.  
  172. Using Turbo C 2.0.
  173.   As per Borland C++ 2.0. Edit linkopt.tc to change location of libraries.
  174.  
  175.  
  176. The file gnuplot.gih is needed for help on the PC.
  177. If the file gnuplot.gih is not in the default directory, then use:
  178.     set GNUHELP={full path name of gnuplot.gih}
  179.  
  180.  
  181.                          ENVIRONMENT VARIABLES
  182.  
  183. See 'help environment'.
  184.  
  185. If the environment variable GNUTERM is found, it is used as the terminal
  186. type. Otherwise, in some cases the variable TERM will be used, or the
  187. hardware may be automatically detected. 
  188.  
  189. The PC version looks for the environment variable GNUPLOT to contain
  190. the name of the directory from which to load the initialization file
  191. GNUPLOT.INI.  See the help on 'start_up' for more information.
  192.  
  193. HOME is examined as a directory where a .gnuplot startup file might be
  194. found. See help on "start-up".
  195.  
  196. If defined, the environment variable GNUHELP is used for the name
  197. of the .gih help file, otherwise HELPFILE (defined in makefile or 
  198. plot.c) is used.
  199.  
  200. The VMS version looks for the logical name GNUPLOT$HELP to locate 
  201. the help library.
  202.  
  203. The CGI drivers need the CGIPATH environment variable to set the path
  204. to the CGI agents, and the CGIDISP and/or CGIPRNT environment
  205. variables to set the output devices.
  206.